Properties

Mode Current view mode.
Possible values:
  • vbmodeText: Text mode
  • vbmodeBinary: Binary mode
  • vbmodeHex: Hex mode
  • vbmodeUnicode: Unicode mode
  • vbmodeUHex: Combined Unicode/Hex mode
TextEncoding Current text encoding.
Used in non-Unicode modes.
Possible values:
  • vencANSI: ANSI (locale dependent)
  • vencOEM: OEM (locale dependent)
  • vencEBCDIC: IBM EBCDIC US
  • vencKOI8: KOI8-R
  • vencISO: ISO (locale dependent)
  • vencMac: Mac (locale dependent)
  • plus many others, see the complete list in ATxCodepages.pas.
Notes:
  • When encoding is OEM, text may be drawn using different font, see FontOEM.
  • Technical notes:
    • ANSI, OEM, EBCDIC, KOI8, ISO, Mac encodings are always available.
    • EBCDIC, KOI8, ISO, Mac encodings are used via MultiByteToWideChar API, if possible. But if they are not installed on OS (for example, on Win9x), then the hardcoded codepages are used.
    • All other encodings are used via MultiByteToWideChar API, they are available only when installed on OS.
TextEncodingName (public, read-only) Name of current text encoding.
Note:
  • It can be read in all modes, even in Unicode. In Unicode modes is will show "UTF-16 LE" or "UTF-16 BE".
TextWrap Enables word wrap.
Works in Text and Unicode modes.
TextWidth
TextWidthHex
TextWidthUHex 		Width of text in fixed-length modes:
  • TextWidth: Binary mode.
  • TextWidthHex: Hex mode.
  • TextWidthUHex: Unicode/Hex mode.
TextWidthFit
TextWidthFitHex
TextWidthFitUHex 		Enables width auto-fit in fixed-length modes.
  • TextWidthFit: Binary mode.
  • TextWidthFitHex: Hex mode.
  • TextWidthFitUHex: Unicode/Hex mode.
Note:
  • These properties work correctly only with monospaced fonts. With fonts of variable width you can get text partially not fitting in the control.
TextSearchIndentVert
TextSearchIndentHorz 		Text indents, used when text is highlighted with successfull FindText / FindNext methods call.
  • TextSearchIndentVert: number of lines above selection.
  • TextSearchIndentHorz: average number of chars lefter than selection.
TextTabSize Tabulation (#9) size.
TextOemSpecial Enables usage of special OEM font (when TextEncoding = vencOEM).
Note:
  • This property should be set to True only on older Win9x systems. NT systems support displaying of OEM text in Unicode (using MultiByteToWideChar API and Unicode fonts), so special OEM font is not needed.
TextNonPrintable Enables displaying of non-printable characters.
Note:
  • When enabled, spaces are shown as small dots, tabs (#9) are shown as "right arrows", and line ends are shown as "paragraphs".
TextGutter
TextGutterWidth 		Gutter (vertical bar on the left) options:
  • Enables gutter.
  • Gutter width.
Font (inherited)
FontOEM
FontFooter 		Fonts:
  • Default font.
  • OEM text font. Used in Text/Binary/Hex modes when (TextEncoding = vencOEM) and (TextOemSpecial = True).
  • Font used for printing footer.
Color (inherited)
TextColorGutter
TextColorHex
TextColorHex2
TextColorHexBack
TextColorLines
TextColorError 		Colors of:
  • Text background
  • Gutter
  • Hex digits (even)
  • Hex digits (odd)
  • Hex digits background
  • Hex mode vertical lines
  • Error messages (displayed when read error occurs)
AutoReload
AutoReloadBeep
AutoReloadFollowTail 		File auto-reloading options:
  • Enables auto-reload.
  • Enables beep on reload.
  • Enables repositioning at the file end, if previous view position was also at the end.
TextPopupCommands Set of commands visible in the popup (right-click) menu.
Commands available:
  • vpCmdCopy: Copy selection to Clipboard.
  • vpCmdCopyHex: Copy selection in hex form in Hex mode.
  • vpCmdSelectLine: Select current line.
  • vpCmdSelectAll: Select all text.
  • vpCmdEncMenu: Show encodings menu.
TextPopupCaption[AIndex: TATPopupCommand]
(public, write-only) 		Captions of popup (right-click) menu items.
For possible values of AIndex see TextPopupCommands.
MaxLengths[AIndex: TATBinHexMode] (public) Maximal line lengths.
These values are for all view modes of ATBinHex control: Text, Binary, Hex, Unicode. They set internal values that define the maximal length of a single string in a file. Values are 300 by default. For example, you may set MaxLengths[vbmodeText] to 1000 if user needs to work with strings of length 1000 in Text mode.
Notes:
  • Larger values increase size of memory buffer for a file, and slow down file reading.
  • Values are applied after file reopening, e.g. after calling Open/OpenStream/Reload methods and after changing Mode property.
MaxClipboardDataSizeMb (public) Maximal data size (in Mb) for copying to Clipboard.
Default value is 16 (Mb), which prevents visual "hanging" when too large block is selected accidentally before copying.
SelStart (public)
SelLength (public)
SelText (public, read-only)
SelTextW (public, read-only)
SelTextShort (public, read-only)
SelTextShortW (public, read-only) 		Current selection properties:
  • SelStart: Selection start (Int64, 0-based).
  • SelLength: Selection length (Int64).
  • SelText: Selection text (AnsiString) in non-Unicode modes.
  • SelTextW: Selection text (WideString) in Unicode mode.
  • SelTextShort: Same as SelText, but limited to the length of 256 chars.
  • SelTextShortW: Same as SelTextW, but limited to the length of 256 chars.
Note:
  • You should call SelText/SelTextW inside try...except block, because when selection is too big, exception is generated.
PosPercent
PosOffset
PosLine (public) 		Current scroll position:
  • Relative position in percents (%).
  • Absolute offset (Int64, 0-based).
  • Line number (1-based, 0 if line number is not found).
Notes for line numbers:
  • Lines are separated by: #13#10, #13, #10.
  • Line numbers are counted only for the first ~1Mb of file. And there is also limit for number of lines in that size.
  • Line numbers are counted for the "current" copy of file, they may be incorrect if file was changed (and not reloaded) since the last display.
SearchResultStart
SearchResultLength (public, read-only) 		Last search result:
  • Search match position (Int64, 0-based).
  • Search match length.
MarginLeft
MarginTop
MarginRight
MarginBottom (public) 		Printing margins.
Currently in mm.